home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / dnet / dnet.doc < prev    next >
Encoding:
Text File  |  1994-02-11  |  9.9 KB  |  268 lines
  1.  
  2.                 AMIGA-DNET V2.00
  3.  
  4.  
  5.                 AMIGA CONFIGURATION
  6.  
  7.     ENV:        must be assigned and writable.
  8.     S:DNET.CONFIG   contains configuration info for DNet
  9.     S:DNET.SERVERS  contains the server list for dnet (and paths to
  10.             the server executables)
  11.  
  12.     Any DNet clients you wish to run or have DNet run must be in your path.
  13.     (i.e. FTERM, PUTFILES, GETFILES ...)
  14.  
  15.     Other files will be required if you intend to run DNet *as* a BBS.
  16.  
  17.  
  18.  
  19.  
  20.                   DNET OPTIONS
  21.  
  22.     (please refer to S:DNET.CONFIG while reading this)
  23.  
  24.     DNet runs in three basic modes:  AutoAnswer (-a), DialOut (default),
  25.     and Manual (-X).  Each mode has its own default set of security
  26.     parameters.  The shipped defaults assume a hostile enviroment.
  27.     Generally,    AutoAnswer is assumed to be the most hostile since you
  28.     do not know who is calling you up.    DialOut is less so since you know
  29.     who you are dialing, and Manual assumes a non-hostile enviroment.
  30.  
  31.     These three modes also cause DNet to work differently.
  32.  
  33.  
  34. AMIGA/DNET
  35.  
  36.     DialOutMode:    The default mode is DialOutMode (neither -X or -a
  37.         given).  DNet will look for a CONNECT message on carrier
  38.         detect and modify the baud rate according to the AUTA
  39.         resources.
  40.  
  41.         DNet will set the security modes to the ENVO (originate)
  42.         resources in s:dnet.config
  43.  
  44.         NOTE:  response through the initial window will be slow due
  45.         to DNet's scanning of the resource file s:dnet.config.
  46.  
  47.     -X        Manual mode.  DNet will look for a CONNECT message on
  48.         carrier detect and modify the baud rate on connect
  49.         appropriately.
  50.  
  51.         DNet will set the security modes to the ENVM resources
  52.         which assumes a friendly connection.
  53.  
  54.     -a        Auto Answer mode.  DNet will send the RESM resources at
  55.         the originally specified baud rate to reset the modem
  56.         whenever carrier is lost.
  57.  
  58.         The security modes are set the the ENVA resources, which
  59.         normally assume a hostile enviroment.
  60.  
  61.     -8        Use 8 bits no parity for the initial window rather than
  62.         7 bits even parity.  NOTE!  This only effects the initial
  63.         login window.  The Protocol, when running, always uses
  64.         8 bits no parity.
  65.  
  66.     -bbaud    Set Initial Baud rate (otherwise uses preferences baud
  67.         rate)
  68.  
  69.     -Bbaud    Set Baud used to determine timeouts.  If not set, the
  70.         current baud rate, whatever that is, is used.  If set,
  71.         this value is used to calculate timeouts forever after
  72.         no matter what the actual line baud rate is.
  73.  
  74.         For example, setting this value lower than whatever baud
  75.         rate you normally use will allow for longer line delays
  76.         (such as when dialing through networks and things)
  77.  
  78.     -sclient    Run the specified client program on protocol start.  If
  79.         running a BBS you want to specify the BBS client program
  80.         here.
  81.  
  82.         NOTE:  If the DNET_NORUNCLIENT enviroment variable is set,
  83.         no client program will be run even if this option is
  84.         specified.  This is used by DBBS to ensure that DNet does
  85.         not start it several times.  This enviroment variable is
  86.         automatically deleted when DNET is first run.
  87.  
  88.         The default is to run the FTERM client.
  89.  
  90.  
  91.     -nhostname    Set the hostname (not used)
  92.  
  93.     -h0     Disable the auto-hangup feature.  This only works when
  94.         in DialOut (default) or Manual (-X) mode and causes DNet to
  95.         ignore the carrier detect line.  CD MUST be implemented for
  96.         AutoAnswer.
  97.  
  98.     -U#     Set the unit number for the low level serial-like device
  99.         to talk over.
  100.  
  101.     -Ddevice    Set the device name for the low level serial-like device
  102.         to talk over (i.e. "serial.device").
  103.  
  104.     -N#     Set the network ID for local client/server rendezvous
  105.  
  106.     -p        Packet Debug mode
  107.  
  108.     -d        Debug mode on
  109.  
  110.          ---------------------------------------------------
  111.                 SECURITY
  112.  
  113.     The following enviroment variables should exist:
  114.  
  115.     DNET_LEVEL, DNET_READ, DNET_WRITE, DNET_GROUP, DNET_USERID
  116.  
  117.     These are setup automatically by the S:dnet.config file depending on
  118.     the mode (Manual, DialOut (-X), AutoAnswer (-a)) and are read by local
  119.     servers to determine what the remote machine is allowed to do.  These
  120.     variables each hold a single value, normally 0-9 (except for DNET_GROUP
  121.     which can be any number 0-32767).
  122.  
  123.     SGCOPY (server for getfiles):
  124.  
  125.     This is a new server.
  126.  
  127.     DNET_READ and DNET_GROUP  determine which files the remote machine may download
  128.     (read).  In order for the remote to be able to download a file,
  129.     that file and all its parent directories are scanned.  At least
  130.     one comment field must have an AC entry (AC=n) less than or
  131.     equal to the current DNET_READ enviroment variable or sgcopy will
  132.     disallow the download.    If NO comment fields have an AC entry
  133.     the download is disallowed.  If any comment field has an AC
  134.     entry > DNET_READ, the download is disallowed unless a GP entry
  135.     was found (GR=n).
  136.  
  137.     A comment field may have multiple GR entries (GR=n GR=n ...).  If
  138.     any matches DNET_GROUP and all (if any) AC fields are <= DNET_READ,
  139.     the download is allowed.
  140.  
  141.     After that point a download will begin and files/dirs need not have
  142.     AC entries.  However, if any do, it will be checked again DNET_READ
  143.     and the download (for that file or directory) disallowed.
  144.  
  145.     SCOPY (server for putfiles)
  146.  
  147.     This server allows remote machines to upload a file.  That is,
  148.     transfer from the remote machine to the local machine.    DNET_WRITE
  149.     must be 9 or higher or the upload will be disallowed.  Currently,
  150.     the remote machine may upload anywhere so it is suggested that you
  151.     either NOT have the SCOPY server installed or do not set DNET_WRITE
  152.     to 9 or beyond when talking to possibly hostile remote machines.
  153.  
  154.     SPRINT (printer server)
  155.  
  156.     This server copies a stream to PRT:  DNET_WRITE must be at least
  157.     6 or the remote machine will not be allowed to use this server.
  158.  
  159.     SCLI (CLI server)
  160.  
  161.     This server is currently a big hack and requires a special pipe
  162.     device to work (The 1.3 pipe: will not work).
  163.  
  164.     DNET_LEVEL must be at least 9 for a remote machine to be able to
  165.     start a remote cli
  166.  
  167.     STERM  (terminal window server)
  168.  
  169.     This server requires no permissions to operate and allows the
  170.     remote machine to bring up a 'terminal window' to talk you
  171.     through.
  172.  
  173.     AUTOMATIC ENVIROMENT VARIABLE CONFIGURATION CAN BE DONE FROM
  174.     S:DNET.CONFIG
  175.  
  176.          ---------------------------------------------------
  177.  
  178.                 TALKING TO A DBBS
  179.  
  180.     Amiga users wishing to connect to DBBS hosts should use the following
  181.     command line:
  182.  
  183.     Run dnet -8 -sbbsterm
  184.  
  185.     The -8 is required only if you have a stupid 'smart' modem which
  186.     figures out the parity and then stays with it forever after.  Since
  187.     neither -a or -X have been given, you are in the medium-security
  188.     'dial-out' mode.
  189.  
  190.     Then, dial up the BBS in question.    If the other end is indeed a
  191.     DNET-BBS running under automatic operation, the protocol should start
  192.     up almost immediately.  On protocol startup, your side will
  193.     automatically attempt to run the BBSTERM program (which connects to the
  194.     BBS server on the other end).  NOTE that the BBSTERM executable and
  195.     FTERM executable are one and the same.  The naming 'BBSTERM' causes
  196.     it to use the BBS's port (8200) instead of the STERM port (8195)
  197.  
  198.     Currently the BBS server will allow only one connection at a time and
  199.     return other attempts with an error.  However, you can still download,
  200.     upload, readmail, and talk to the sysop all at the same time.
  201.  
  202.             Downloading files from the DBBS
  203.  
  204.     The getfiles client program is used to retrieve files from the DBBS.
  205.     The DBBS will set security options and such to allow you to download
  206.     files.
  207.  
  208.             Allowing the DBBS to upload files from you
  209.  
  210.     At least one of the directories in the path leading to the eventual
  211.     file/dir that you want to upload to the BBS must have a comment
  212.     field containing the string AC=<n>    (e.g. AC=1) where <n> is at least
  213.     whatever read security level you have set (the DNET_READ enviroment
  214.     variable, for example:  setenv DNET_READ 1), or the DBBS will be unable
  215.     to retrieve the file(s)/dir(s) and will tell you so.
  216.  
  217.  
  218.          ---------------------------------------------------
  219.                    EMAIL NETWORK
  220.  
  221.     Has not been implemented yet, but will eventually be just another
  222.     server.  This is one of the reasons why the connect-to-BBS is done
  223.     by the caller rather than have the BBS automatically startup an STERM
  224.     on protocol startup ... this way, future enhancements such as an
  225.     automated email network can be added without the burden of automatically
  226.     starting up a BBS everytime.
  227.  
  228.     I also plan to implement a CRON based auto-dialer for email transfer.
  229.  
  230.         ----------------------------------------------
  231.  
  232.                    RUNNING AS A DBBS
  233.  
  234.     The DBBS server program is a BBS system for the Amiga which runs under
  235.     DNet.  The following is an example command line for automatic
  236.     operation.    Your modem must implement the CD (carrier detect) line and
  237.     must disconnect when DTR is dropped.
  238.  
  239.     Run dnet -8 -a -bmaxbaud -sdbbs     (other options may apply)
  240.  
  241.     That is, 8 bits no parity for the initial window (doesn't matter unless
  242.     you have one of those stupid-smart modems), answer mode (automatic
  243.     protocol startup on carrier detect), the maximum baud rate your modem
  244.     can handle, and to run the DBBS client on protocol startup.
  245.  
  246.     The DBBS program is the BBS program itself.  It is a client in that you
  247.     RUN it (or allow DNET to run it via the -s option).  It is a server in
  248.     that it passively waits for connections from the remote end.  This
  249.     program also handles disconnecting users when their time runs out or
  250.     they are idle too long.
  251.  
  252.     REFER to DBBS.DOC FOR FURTHER INFORMATION
  253.  
  254.     Since PUTFILES is a security hole right now, rather than have users
  255.     of the BBS PUTFILES to upload, they will request the BBS to GETFILES
  256.     the files to upload.
  257.  
  258.     *NEVER SET YOUR DNET_LEVEL or DNET_WRITE TO 9 OR ABOVE!  Doing so gives
  259.      remote users sysop level access to DNet.
  260.  
  261.     NOTE:   I intend to implement a mail network at some point.  Remember
  262.     that in the future, users will dial up and connect to your machine to
  263.     do things other than just use the DBBS (i.e. they'll connect to the
  264.     EMAIL server in many cases for an automated mail transfer).
  265.  
  266.  
  267.  
  268.